Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions / Creating and Manipulating Format Objects

GXDisposeFormat

You can use the GXDisposeFormat function to dispose of a format object.

void GXDisposeFormat (gxFormat aFormat);

aFormat

A reference to the format object whose owner count you want to decrement.

DESCRIPTION

You use the GXDisposeFormat function when you no longer need the format object. The function decrements the format's owner count. When the owner count reaches 0, the format object is deleted.

SPECIAL CONSIDERATIONS

You should not call this function for the default format object unless you have cloned it.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 3-9 on page 3-42 shows how to use the GXDisposeFormat function to dispose of a format object.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help